home *** CD-ROM | disk | FTP | other *** search
/ QRZ! Ham Radio 6 / QRZ Ham Radio Callsign Database - Volume 6.iso / mac / files / finland / ddlcpack.lzh / DDLC.DOC < prev    next >
Text File  |  1992-08-24  |  3KB  |  104 lines
  1.     A KA9Q NOS device driver for OH1MQK's "Dual-DDLC" card
  2.  
  3.  
  4.         The Dual-DDLC-card ("the card") has 2 or 4 synchronous
  5.     serial channels capable of operating up to (about) 4 Mbps each.
  6.     Dual-port memory access constraints limit the speed of all
  7.     channels together to about the said 4 Mbps.
  8.     However, that should be enough for most uses :-)
  9.  
  10.  
  11.         The card has synchronous interfaces (see cards technical
  12.     documentation) which contains INPUTS of Rx and Tx CLOCKS, Rx and
  13.     Tx data, RTS, CTS, and a couple of general purpose signals (1 input,
  14.     1 output). (Alike any decent synchronous modem interface.)
  15.  
  16.         The card is completely MEMORY MAPPED device, and does not
  17.     have any IO-space locations.  It can be configured to be in any
  18.     address within the low 1MB of PC/XT/AT/AT386 memory space at incre-
  19.     ments of 16kB.  The card can be configured to use 16kB or 32kB of
  20.     memory space.
  21.  
  22.         The card uses an on-board SRAM as a buffer for incoming, and
  23.     outgoing packets - alike most Ethernet boards.
  24.  
  25.         The card has no access-speed limitations (unlike 8530 et.al.),
  26.     and thus has no need to do fancy delays while accessing it.
  27.  
  28.         Due to PC's INT-high-active nature, the card can't share
  29.     INT with another card via PC-Bus INT signal.
  30.  
  31.  
  32.  
  33.     Usage of the  ATTACH  command:
  34.  
  35.         attach ddlc INIT IO-BASE INT-NRO [BOARD-SIZE]
  36.         attach ddlc CHANNEL MODE LABEL MTU SPEED DUPLEX [IP-ADDR]
  37.  
  38.     Where:
  39.         INIT        "init" - lowercase special label.
  40.                 Indicates board definition statement. Must be
  41.                 done before the actual channel attach is done.
  42.  
  43.         IO-BASE        Base address of the D-DDLC-board.  20-bit
  44.                 hex address in the form of  HHHHH.
  45.                 For example:  A0000
  46.  
  47.         INT-NRO        INT-vector number of the board.
  48.  
  49.     *    NR-OF-CHIPS    1 or 2
  50.                 Number of equiped chips on this board.
  51.                 If 1, then it must be for channels 0 and 1.
  52.  
  53.     *    BOARD-SIZE    "16"/"32"/"16kB"/"32kB"
  54.                 Tells the size of the card (of its on-board 
  55.                 memory size)  -- comes equiped always with
  56.                 32kB, but upper half can be discarded, and
  57.                 address granularity stepped down to 16kB.
  58.  
  59.     ( Params marked with `*' are automatically figured out from the board )
  60.  
  61.  
  62.         The  "attach init" -command must be used before the card
  63.         can get attachements of actual channels.
  64.         In the source files (ddlc.h) is definition of maximum of two
  65.         DDLC cards (DDLCMAX), but as that is up to 8 interfaces,
  66.         it should be enough...
  67.  
  68.  
  69.         CHANNEL        0..7
  70.                 Number of channel to be attached.
  71.                 0..3 on the first card, 4..7 on the second.
  72.                 (And so on, if DDLCMAX is increased.)
  73.                 If the card has only 1 chip, only the first
  74.                 two channels of that card are usable.
  75.  
  76.         MODE        "ax25" or "raw" (alias "hdlc")
  77.                 Lower-case special labels.
  78.                 AX.25 mode and bare HDLC-encapsulation (wire
  79.                 line) supported.
  80.  
  81.         LABEL        "dd0"
  82.                 As usual, label for the channel.
  83.  
  84.         MTU        1500 (or whatever)
  85.                 As usual, MTU size.
  86.  
  87.         SPEED        56000/9600/1200/250000/2000000/...
  88.                 Informative text for status display.
  89.                 interface speed IS NOT configurable
  90.                 by the software.  Both clocks come
  91.                 from the modem.
  92.  
  93.         DUPLEX        "full" / "half" / "fullduplex" / "halfduplex" /
  94.                 (Recognize by the first character; f or h)
  95.                 Tells wether or not the channel has a full
  96.                 or a half-duplex radio-/wire-modem.
  97.  
  98.         IP-ADDR        44.109.04.20
  99.                 Optionally define interface IP number(s).
  100.                 Defaults to global  Ip_addr.
  101.  
  102.  
  103.         Quite normal form of attach-command.
  104.